<!doctype html>
<html class="no-js" lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="x-ua-compatible" content="ie=edge">
<title>ADALM-PLUTO On-board documentation</title>
<meta name="description" content="ADALM-PLUTO On board docs">

<link rel="apple-touch-icon" href="apple-touch-icon.png">
<link rel="shortcut icon" href="img/favicon.ico" type="image/x-icon">
<!-- Place favicon.ico in the root directory -->
<link type="text/css" href="./img/style.css" rel="stylesheet">
</head>
<body>
<!--[if lte IE 11]>
<p class="browserupgrade">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience and security.</p>
<![endif]-->

<!-- Add your site or application content here -->
<header id="top">
<a href="http://www.analog.com">
<img src="img/ADI_Logo_AWP.png" alt="Analog Devices logo" />
</a>
<div class="anchor">
<a href="http://#IP#/index.html" title="network version">Network Version</a> |
<a href="https://my.analog.com/en/app/registration/hardware/ADALM-PLUTO?sn=#SERIAL#&v=#MODEL#">Register your PlutoSDR</a> |
<a href="https://twitter.com/intent/tweet?text=Excited%20to%20try%20out%20my%20new%20@ADI_News%20%23plutosdr%20(ADALM-PLUTO%20http%3A%2F%2Fwww.analog.com%2Fplutosdr)%20Hands%20on%20Learning%20Module%20for%20Software%20Defined%20Radio%20pic.twitter.com%2F7JxgynEa8w&hashtags=matlab%2Cgnuradio%2Csdrangel%2Csdrsharp&related=twitter%3AADI_News" title="Click to Tweet">Share PlutoSDR: <img style="width: 32px;" src="./img/tw.png" alt="Twitter Logo"></a>
</div>
</header>

<nav style="text-align: center;">
<a class="button" href="#started">Get Started</a>
<a class="button" href="#framework">Frameworks</a>
<div class="dropdown">
<span><a class="button" href="#firmware">Firmware &dArr;</a></span>
<div class="dropdown-content">
<p><a class="button" href="#firmware">Upgrade Firmware</a></p>
<p><a class="button" href="#version">Version Info</a></p>
<p><a class="button" href="#target">Custom Apps</a></p>
<p><a class="button" href="#config">Config Settings</a></p>
<p><a class="button" href="#wifi">Wi-Fi Settings</a></p>
<p><a class="button" href="#wired">Wired Settings</a></p>
</div>
</div>
<div class="dropdown">
<span><a class="button" href="http://www.analog.com/sdrforengineers">Book &dArr;</a></span>
<div class="dropdown-content">
<p><a class="button" href="https://www.analog.com/media/en/training-seminars/design-handbooks/Software-Defined-Radio-for-Engineers-2018/SDR4Engineers.pdf">Download PDF</a></p>
<p><a class="button" href="http://us.artechhouse.com/Software-Defined-Radio-for-Engineers-P1951.aspx">Hard Cover</a></p>
<p><a class="button" href="https://www.amazon.com/Software-Defined-Radio-Engineers-Travis-Collins/dp/1630814571">Amazon</a></p>
<p><a class="button" href="http://www.sdrforengineers.com">Web Site</a></p>
<p><a class="button" href="http://www.sdrforengineers.com#tutorials">Tutorials</a></p>

</div>
</div>
<a class="button" href="#support">Help and Support</a>
<a class="button" href="LICENSE.html">License</a>
<a class="button" href="#about">About Analog Devices</a>
</nav>
<hr>
<section>
<h1>Welcome to the <strong>ADALM-PLUTO</strong> Active Learning Module</h1>
<a href="http://www.analog.com/education"><img src="./img/prof_blue.png" alt="ADI Professor" style="float:left" /></a>
<p style="margin-bottom:0em;">Thank you for purchasing the <a href="http://www.analog.com/plutosdr">ADALM-PLUTO</a> Active Learning Module (PlutoSDR). The easy-to-use PlutoSDR helps introduce the fundamentals of software-defined radio (SDR), radio frequency (RF), and wireless communications to everyone. Designed for users at all levels and all backgrounds, the PlutoSDR can be used as:</p>
<ul style="margin-left:8em; margin-top:0em;"><li>A learning module for instructor-led or self-directed learning to develop a foundation in real-world RF and communications in the pursuit of science, technology, or engineering degrees.</li>
<li>A tool for practicing engineers and industry practitioners who are interested in mastering the design, implementation, and experimentation of communication systems. The PlutoSDR can be used to examine how well the communications system operates in terms of successfully transmitting or recovering intercepted signals.</li>
<li>A tool for practicing RF engineers who use <a href="https://en.wikipedia.org/wiki/Spectrum_analyzer">spectrum analyzers</a> or <a href="https://en.wikipedia.org/wiki/Signal_generator#Vector_signal_generator">vector signal generators</a> to capture or create and analyze RF signals. The PlutoSDR with the appropriate <a href="#framework">software tool</a> is capable of analyzing or generating digitally-modulated radio signals that may use any of a large number of formats used in modern communication systems.</li>
<li>A complete reference design (hardware, HDL, embedded software, host software) for developers interested in creating their own products based on <a href="https://www.analog.com/en/applications/technology/sdr-radioverse-pavilion-home/wideband-transceivers.html">Analog Devices Wideband Transceivers</a>.</li></ul>
<p>Based on the <a href="http://www.analog.com/AD9363">AD9363</a>, the PlutoSDR features independent receive and transmit channels that can be operated in full duplex. The PlutoSDR can generate or acquire RF analog signals from 325 MHz to 3800 MHz at up to 61.44 MegaSamples per second (MSPS). Small enough to fit in a shirt pocket, the PlutoSDR is completely self-contained and entirely USB powered with the default firmware. PlutoSDR is enabled by libiio drivers and supports macOS®, Windows®, and Linux®, allowing students and engineers to learn and explore on a variety of host platforms.</p>
</section>
<hr>
<section id="started">
<a class="anchor" href="#top">Back to top</a>
<h3>Getting Started</h3>
<p>The PlutoSDR <a href="https://wiki.analog.com/plutosdr">online documentation</a> provides instruction on how to set up the software on your <a href="https://wiki.analog.com/university/tools/pluto/drivers/windows">Windows</a>, <a href="https://wiki.analog.com/university/tools/pluto/drivers/linux">Linux</a>, or <a href="https://wiki.analog.com/university/tools/pluto/drivers/osx">macOS</a> based host to use the PlutoSDR. For those who do not read instructions, do the following steps:</p>
<ol>
<li id="hideupgrade">Upgrade your <a href="#firmware">Firmware</a>
<li id="hidedriver">Install the Windows <a href="https://github.com/analogdevicesinc/plutosdr-m2k-drivers-win/">driver</a> : <a id="drivertest" href="https://github.com/analogdevicesinc/plutosdr-m2k-drivers-win/releases/latest">Latest Windows Driver</a></li>
<li>Install the <a href="https://github.com/analogdevicesinc/libiio">libiio</a> Library: <div id="hidelib" style="display:none"> OS: <select id="os-select" onchange="libiio_type()"></select> Type : <select id="type-select" onchange="libiio_ver()"></select> Version : <select id="ver-select" onchange="libiio_url()"></select></div> : <a id="libtest" href="https://github.com/analogdevicesinc/libiio/releases/latest">Latest version of the libiio</a></li>
</ol>
<p id="test"><strong>Test your installation:</strong></p>
<p>Once everything above is installed, with your favorite console (Windows Linux or macOS), try these two commands (in bold below) to make sure the drivers and software is installed properly. It is expected that the serial number (specific to the PlutoSDR device) and usb uri (the three numbers after the <kbd>'usb:'</kbd> field, based on your host) will be different than the examples below.</p>
<pre class=xterm>
<span id="prompt0">rgetz@brain:~/$</span> <strong>iio_info -s</strong>
Library version: 0.16 (git tag: 5cdeaaa)
Compiled with backends: local xml ip usb serial
Available contexts:
	0: 0456:b673 (Analog Devices Inc. PlutoSDR (ADALM-PLUTO)), serial=100000235523730700190030090216fd23 [usb:3.15.5]

<span id="prompt1">rgetz@brain:~/$</span> <strong>iio_info -u ip:192.168.2.1</strong>
Library version: 0.16 (git tag: 5cdeaaa)
Compiled with backends: local xml ip usb serial
IIO context created with network backend.
Backend version: 0.15 (git tag: v0.15  )
Backend description string: 192.168.2.1 Linux (none) 4.9.0-10475-g2398d50 #269 SMP PREEMPT Mon Oct 15 20:18:34 CEST 2018 armv7l
IIO context has 8 attributes:
        hw_model: Analog Devices PlutoSDR Rev.A (Z7010-AD9363)
        hw_model_variant: 0
        hw_serial: 100000235523730700190030090216fd23
....
			2 channel-specific attributes found:
				attr  0: scale value: 6.433105468
				attr  1: raw value: 778
</pre>
<p>If the <b><kbd>'iio_info -s'</kbd></b> command cannot find the PlutoSDR on your host, you will need to do some <a href="https://wiki.analog.com/plutosdr">reading and troubleshooting</a>. If you are having issues installing the software, check out the <a href="http://www.sdrforengineers.com/#tutorials">on-line tutorials</a>. Once the software is running, you can enable PlutoSDR in your communications framework like MATLAB, by following along the <a href="http://www.sdrforengineers.com/#tutorials">on-line tutorials</a>.</p>
</section>
<hr>
<section id="framework">
<a class="anchor" href="#top">Back to top</a>
<h3>Frameworks</h3>
<p>Use the PlutoSDR with your favorite communications framework, visualization, or signal processing tool.</p>
<table>
<thead>
<tr>
<th>Framework / Application</th>
<th>OS</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:center"><a href="https://www.mathworks.com/discovery/sdr"><img src="img/mathworks_logo.png" alt="MathWorks logo"/></a></td><td><a href="https://www.mathworks.com/support/sysreq.html">Windows, Linux, macOS</a></td>
<td>Communications Toolbox™ <a href="https://www.mathworks.com/hardware-support/adalm-pluto-radio.html">Support Package</a> for Analog Devices PlutoSDR (<a href="https://www.mathworks.com/help/supportpkg/plutoradio/getting-started-with-communications-system-toolbox-support-package-for-pluto-radio.html">doc</a>) enables you to use MATLAB® and Simulink® to prototype, verify, and test practical wireless systems. Request a <a href="https://www.mathworks.com/campaigns/products/trials.html?prodcode=CM">zero cost trial</a> and then use, study, modify, and/or distribute a variety of MATLAB and Simulink <a href="https://www.mathworks.com/examples/communications/category/plutoradio">examples</a>.</td>
</tr>
<tr>
<td style="text-align:center;"><a href="https://www.gnuradio.org/"><img src="img/GNURadio_logo.png" alt="GNU Radio logo" /></a></td><td>Linux, macOS</td>
<td>GNU Radio is a Free and Open-Source Toolkit for Software Radio, primarily supported on Linux operating systems. It has both generic IIO blocks, and <a href="https://wiki.analog.com/university/tools/pluto/gnuradio">PlutoSDR specific blocks</a></td>
</tr>
<tr>
<td><a href="https://wiki.analog.com/resources/tools-software/linux-software/libiio/cmd_line">IIO Command Line Tools</a></td><td>Windows, Linux, macOS</td>
<td><a href="https://wiki.analog.com/resources/tools-software/linux-software/libiio/iio_info">iio_info</a>,
<a href="https://wiki.analog.com/resources/tools-software/linux-software/libiio/iio_attr">iio_attr</a>,
<a href="https://wiki.analog.com/resources/tools-software/linux-software/libiio/iio_readdev">iio_readdev</a>,
<a href="https://wiki.analog.com/resources/tools-software/linux-software/libiio/iio_writedev">iio_writedev</a>,
<a href="https://wiki.analog.com/resources/tools-software/linux-software/libiio/iio_reg">iio_reg</a>
for interacting with the PlutoSDR from your favorite shell.
</td>
</tr>
<tr>
<td><a href="https://github.com/analogdevicesinc/iio-oscilloscope/releases/latest"><img style="vertical-align:middle;" src="img/osc128.png" alt="Osc logo"><span style="vertical-align:middle;">&nbsp;IIO Oscilloscope</span></a></td><td>Windows, Linux</td>
<td>The IIO Oscilloscope is an application, which demonstrates how to interface various IIO devices to different visualization methods on Linux and Windows</td>
</tr>
<tr>
<td><a href="https://github.com/f4exb/sdrangel"><img src="img/sdrangel.png" alt="SDRAngel logo"/></a></td><td>Windows, Linux</td>
<td><a href="https://github.com/f4exb/sdrangel/releases/latest">SDRangel</a> is an Open Source Qt5 / OpenGL 3.0+ SDR and signal analyzer frontend to various hardware. Check the <a href="https://groups.io/g/sdrangel">discussion group</a> and <a href="https://github.com/f4exb/sdrangel/wiki">wiki</a>. While SDRangel seeks to be approachable, it is targeted towards the experienced SDR user with some digital signal processing understanding.</td>
</tr>
<tr>
<td><a href="https://www.rtl-sdr.com/plutosdr-quickstart-guide/"><img src="img/SDR-Sharp.png" alt="SDR Sharp logo"></a></td><td>Windows</td>
<td><a href="https://airspy.com/download/">SDR# (SDR Sharp)</a> is a popular SDR program for the <a href="https://airspy.com/">Airspy</a>, and supports the PlutoSDR with a <a href="https://github.com/Manawyrm/sdrsharp-plutosdr/releases/latest">third party</a> plugin. A complete installation <a href="https://www.rtl-sdr.com/plutosdr-quickstart-guide/">tutorial exists</a>.</td>
</tr>
<tr>
<td><a href="https://wiki.analog.com/university/tools/pluto/other">other tools</a>
</td><td>Windows, Linux, macOS</td>
<td>A variety of other tools and projects using the PlutoSDR</td>
</tr>
</tbody>
</table>


<p>Detailed documentation can be found at the <a href="https://wiki.analog.com/plutosdr">Main Documentation</a> page. Information on regulatory compliance and safety information can be found <a href="https://wiki.analog.com/university/tools/pluto/common/regulatory_compliance">online</a>.</p>
</section>
<hr>
<section id="firmware">
<a class="anchor" href="#top">Back to top</a>
<h3>Firmware</h3>
<p>The <i>ADALM-PLUTO Firmware</i> refers to the U-Boot, HDL, Linux kernel, device drivers, and user space software, which runs on the PlutoSDR. This is bundled up and given a specific version number for the PlutoSDR. For help upgrading firmware, check out the <a href="https://wiki.analog.com/university/tools/pluto/common/firmware">online documentation</a>.</p>
<div id="versionsection" class="download">
<p><strong>Status of the PlutoSDR firmware:</strong></p>
<p><span id="versiontest">Need javascript to check (sorry)</span></p>
<p><a id="plutsdr-fw-download" class="button" href="https://github.com/analogdevicesinc/plutosdr-fw/releases/latest">Check the latest version</a>
</div>
<br>
<a class="anchor" href="#top">Back to top</a>
<p id="version"><strong>Version Information:</strong></p>
<p>The various parts of the firmware all have their own unique versions as well:</p>
<table>
<thead>
<tr>
<th>Model</th>
<th>#MODEL#</th>
</tr>
</thead>
<tbody>
<tr>
<td>Serial</td>
<td>#SERIAL#</td>
</tr>
<tr>
<td>Build</td>
<td>#BUILD#</td>
</tr>
<tr>
<td>Linux</td>
<td>#LINUX#</td>
</tr>
<tr>
<td>U-Boot</td>
<td>#UBOOT#</td>
</tr>
<tr>
<td>FPGA</td>
<td>#FPGA#</td>
</tr>
<tr>
<td>Root FS</td>
<td>#ROOTFS#</td>
</tr>
<tr>
<td>IIO</td>
<td>#IIO#</td>
</tr>
<tr>
<td>Network over USB</td>
<td>#NETWORKUSB#</td>
</tr>
</tbody>
</table>
<a class="anchor" href="#top">Back to top</a>
<p id="target"><strong>Standalone Applications:</strong></p>
<p><a href="https://wiki.analog.com/university/tools/pluto/devs/embedded_code">Custom C/C++ applications</a> can be created/compiled on a host with a <a href="https://releases.linaro.org/components/toolchain/binaries/">Linaro GNU Compiler Collection (GCC)</a> toolchain (with the appropriate flags), transferred over and run directly on the PlutoSDR.</p>
<table>
<tbody>
<tr>
<td>GCC Compiler <a href="https://collaborate.linaro.org/display/TCWGPUB/ARM+and+AArch64+Target+Triples">Target Triple</a></td>
<td>#GCC_TRIPLE#</td>
</tr>
<tr>
<td>GCC version</td>
<td>#GCC_VERSION#</td>
</tr>
<tr>
<td>Binutils version</td>
<td>#BIN_VERSION#</td>
</tr>
<tr>
<td>SysRoot</td>
<td><a id="sysroot" href="https://github.com/analogdevicesinc/plutosdr-fw/releases/latest">Latest SYSROOT</a></td>
</tr>
</tbody>
</table>
<a class="anchor" href="#top">Back to top</a>
<p id="userpass"><strong>Build Settings:</strong></p>
<p>There are many settings which are set as part of the build configuration, and can not be changed without rebuilding the firmware.</p>
<table>
<tbody>
<tr>
<td>Username:</td>
<td>root</td>
</tr>
<tr>
<td>Password:</td>
<td>#ROOTPASSWORD#</td>
</tr>
</tbody>
</table>
<a class="anchor" href="#top">Back to top</a>
<p id="config"><strong>Configuration Settings:</strong></p>
<p>On the root file system, there are <a href="./config.txt">configuration settings</a> that can modify the default configuration, they currently are:</p>
<table>
<tbody>
<tr>
<td>Hostname</td>
<td>#HOSTNAME#</td>
</tr>
<tr>
<td>IP Address (PlutoSDR)</td>
<td>#IP#</td>
</tr>
<tr>
<td>IP Address (HOST)</td>
<td>#HOSTIP#</td>
</tr>
<tr>
<td>Netmask</td>
<td>#NETMASK#</td>
</tr>
<tr>
<td>MAC Address (PlutoSDR)</td>
<td>#MAC#</td>
</tr>
<tr>
<td>MAC Address (HOST)</td>
<td>#MACHOST#</td>
</tr>
</tbody>
</table>
<a class="anchor" href="#top">Back to top</a>
<p id="wifi">Wi-Fi <a href="./config.txt">Update</a></p>
<table>
<tbody>
<tr>
<td>SSID</td>
<td>#SSID_WLAN#</td>
</tr>
<tr>
<td>WPA-PSK Passphrase</td>
<td>********</td>
</tr>
<tr>
<td>IP Address</td>
<td>#IPADDR_WLAN#</td>
</tr>
</tbody>
</table>
<a class="anchor" href="#top">Back to top</a>
<p id="wired">Wired Ethernet using a USB Ethernet adapter. <a href="./config.txt">Update</a></p>
<table>
<tbody>
<tr>
<td>IP Address</td>
<td>#IPADDR_ETH#</td>
</tr>
<tr>
<td>Netmask</td>
<td>#NETMASK_ETH#</td>
</tr>
</tbody>
</table>

<p>To change these settings, check the <a href="https://wiki.analog.com/university/tools/pluto/common/customizing">on-line documentation</a>.</p>
</section>
<hr>
<section id="support">
<a class="anchor" href="#top">Back to top</a>
<h3>Help and Support</h3>
<p>If you have any questions regarding the PlutoSDR or are experiencing any problems following the user guides, or experiments feel free to ask us a question. Questions can be asked on our <a href="http://ez.analog.com/university-program">Virtual Classroom</a>. Help and support for the PlutoSDR is provided exclusively <a href="https://wiki.analog.com/university/tools/pluto/help_support">online</a>. If you don't have an internet connection on this computer, please find one that does. </p>
</section>
<hr>
<section id="social">
<div>
<ul class="quicklinks">
<li><a href="http://www.analog.com/en/about-adi.html" title="About ADI">About ADI</a></li>
<li><a href="http://www.analog.com/en/analog-dialogue.html" title="Analog Dialogue">Analog Dialogue</a></li>
<li><a href="http://www.analog.com/en/about-adi/careers.html" title="Careers">Careers</a></li>
<li><a href="http://www.analog.com/en/about-adi/careers/students-and-graduates/new-college-graduates.html" title="Students and Graduates">New College Graduates</a></li>
<li><a href="http://investor.analog.com/" title="Investor Relations">Investor Relations</a></li>
<li><a href="http://www.analog.com/en/about-adi/news-room.html" title="News Room">News Room</a></li>
<li><a href="http://www.analog.com/en/about-adi/corporate-information/sales-distribution.html" title="Sales &amp; Distributors">Sales &amp; Distribution</a></li>
<li><a href="https://form.analog.com/Form_Pages/corporate/parts.aspx" title="College Parts Program">College Parts Program</a></li>
</ul>
</div>
<h3 id="about">About Analog Devices</h3>
<div class="colLeft">
<p><a href="https://www.analog.com/">Analog Devices</a> (Nasdaq: <a href="https://www.nasdaq.com/symbol/adi">ADI</a>) is a leading global high-performance analog technology company dedicated to solving the toughest engineering challenges. We enable our customers to interpret the world around us by intelligently bridging the physical and digital with unmatched technologies that sense, measure, power, connect and interpret.</p>
</div>
<div style="clear: both">
<p>We offer <a href="http://www.analog.com/en/analog-dialogue.html">technical journals</a> and other <a href="http://ez.analog.com/">community resources</a> to engineers, scientists, technicians, and students looking to help and share with one another. Interested in the latest news and articles about ADI products, design tools, training and events? Choose from one of our 12 newsletters that match your product area of interest, delivered monthly or quarterly to your inbox. <a href="https://my.analog.com/en/myanalog/manage-updates/manage-newsletters.html">Sign up</a></p>
<p>Follow Analog Devices on your favorite <a href="http://www.analog.com/social"> social media site</a>:</p>
</div><div style="clear: both">
<p><a href="http://ez.analog.com/welcome" title="Join Analog Devices on EngineerZone"><img src="./img/ez.png" alt="EngineerZone logo"></a>
<a href="http://www.facebook.com/AnalogDevicesInc" title="Visit Analog Devices on Facebook"><img src="./img/fb.png" alt="FaceBook Logo"></a>
<a href="https://twitter.com/#!/adi_news" title="Follow Analog Devices on Twitter"><img src="./img/tw.png" alt="Twitter Logo"></a>
<a href="https://www.instagram.com/analogdevices/?hl=en" title="Follow Analog Devices on Instagram"><img src="./img/ig.png" alt="Instgram Logo"></a>
<a href="http://plus.google.com/116502491843999760953/posts" title="Follow us on Google+"><img src="./img/gp.png" alt="Google+ Logo"></a>
<a href="http://www.linkedin.com/company/3450" title="Join Analog Devices on LinkedIn"><img src="./img/li.png" alt="LinkedIn Logo"></a>
<a href="http://www.youtube.com/user/AnalogDevicesInc" title="View Analog Devices on YouTube"><img src="./img/yt.png" alt="YouTube Logo"></a>
<a href="http://www.weibo.com/analogdevices" title="Chinese language information on Sina Weibo"><img src="./img/sw.png" alt="Sina Weibo Logo"></a>
<a href="http://i.youku.com/u/UMzA0Njk0MDI0" title="View Analog Devices on YouKu"><img src="./img/yk.png" alt="YouKu Logo"></a>
<a href="http://www.slideshare.com/analogdevicesinc" target="_blank" title="Visit our official SlideShare channel to gain access to technical presentations"><img src="./img/ss.png" alt="SlideShare Logo"></a>
</p>
</div>
</section>
<hr>
<footer>
<p>&copy; 2017-2019 ANALOG DEVICES, INC. ALL RIGHTS RESERVED.</p>
</footer>
<script src="https://code.jquery.com/jquery-3.1.1.min.js" integrity="sha256-hVVnYaiADRTO2PzUGmuLJr8BLUSjGIZsDYGmIJLv2b8=" crossorigin="anonymous"></script>
<script>window.jQuery || document.write('<script src="js/vendor/jquery-3.1.1.min.js"><\/script>')</script>
<script src="./img/version.js"></script>
</body>
</html>
